Cursor中对@符号的准确使用，很大程度上决定了声称内容的准确性。
在 Cursor 或类似的 AI 编程工具中，@code、@codebase、@files、@folders 是用于控制 AI 上下文范围的指令，但它们的粒度、作用范围和使用场景有所不同。以下是详细区别和使用方法：
1. @code
- 作用范围：
仅限 当前打开的文件（或选中的代码片段）。 - 用途：
聚焦于当前文件的代码逻辑，适用于单文件内的操作。 - 使用场景：
- 解释当前函数/类的作用
- 修复当前文件的语法错误
- 生成与当前代码相关的补全片段
- 示例：
1
2@code 请优化这个函数的性能
@code 解释这段代码的逻辑
2. @codebase
- 作用范围：
整个项目（当前打开的工作区目录），包括所有文件和子目录。 - 用途：
需要跨文件分析项目结构或依赖关系时使用。 - 使用场景：
- 生成与多文件交互的代码（如调用其他模块的 API）
- 分析项目的架构设计
- 重构涉及多个文件的代码
- 示例：
1
2@codebase 如何统一管理项目的全局配置？
@codebase 请检查整个项目的类型定义是否一致
3. @files
- 作用范围：
指定 一个或多个具体文件（通过路径或通配符匹配）。 - 用途：
针对特定文件的代码操作，比@codebase更灵活，但比@code更广。 - 使用场景：
- 分析多个关联文件（如组件和其依赖的 utils 文件）
- 生成跨文件的代码逻辑（如接口和实现类）
- 检查指定文件的兼容性
- 示例：
1
2@files src/utils/helper.js 请为这个工具函数添加注释
@files src/components/*.jsx 检查所有组件是否遵循编码规范
4. @folders
- 作用范围：
指定 某个目录下的所有文件（支持递归子目录）。 - 用途：
批量处理某个文件夹内的代码，适合模块化或分层项目。 - 使用场景：
- 批量重命名或重构某个模块的代码
- 分析某个目录下的代码风格一致性
- 生成目录内文件的文档
- 示例：
1
2@folders src/api 请为所有 API 文件生成 TypeScript 类型定义
@folders tests/unit 检查测试覆盖率是否达标
关键对比
| 指令 | 范围 | 适用场景 | 灵活性 | 性能影响 |
|---|---|---|---|---|
@code |
当前文件 | 单文件操作 | 低（单一） | 最低 |
@codebase |
整个项目 | 跨文件、全局架构分析 | 高（全局） | 较高 |
@files |
指定文件（多个） | 精准控制多个文件 | 中（自定义） | 中等 |
@folders |
指定目录（递归） | 批量处理模块或分层代码 | 中（批量） | 中等/较高 |
使用技巧
精确控制上下文：
- 优先用
@code处理简单问题，用@files或@folders处理局部复杂逻辑。 - 仅在需要全局分析时使用
@codebase（避免资源浪费）。
- 优先用
路径语法：
- 支持通配符（如
*.js）和相对路径：1
2@files src/components/Button/*.js 请重构这个组件的样式逻辑
@folders src/hooks 检查所有自定义 Hook 的依赖项
- 支持通配符（如
结合具体操作：
- 生成代码时，指定文件或目录可以避免 AI 脱离实际上下文：
1
@files src/models/User.ts 请为这个模型添加 CRUD 方法
- 生成代码时，指定文件或目录可以避免 AI 脱离实际上下文：
注意隐私与性能：
- 使用
@codebase或@folders时，确保代码不涉及敏感信息（部分工具会上传上下文到云端）。 - 大项目中使用
@codebase可能导致响应延迟，尽量缩小范围。
- 使用
示例场景
单文件修改：
1
@code 将这个函数转换为异步方式
多文件关联操作：
1
@files src/utils/auth.js src/api/login.js 检查登录逻辑的 Token 处理是否一致
模块批量处理：
1
@folders src/components/forms 为所有表单组件添加验证逻辑
全局架构问题：
1
@codebase 如何优化项目的状态管理结构？
总结
@code：单文件快速操作。@files：精准控制多个文件。@folders：批量处理目录代码。@codebase：全局架构或复杂依赖分析。
根据需求选择合适指令，可以显著提升 AI 生成结果的准确性和效率！
我想说的是，如果你看过cursor docs的话，你能感受到这篇文章的实用性。比官网清晰&使用的多。
最后，我想说，感谢deepseek。
